Carteira Nacional de Habilitação
- Upload
- Buscar documento
- Modelo
Para efetuar o upload de um documento do tipo Carteira Nacional de Habilitação, basta enviar uma requisição POST conforme demonstrado abaixo. O seu código interno é o 1.
POST URL Ambiente/documents/upload
Header
| Identificador | Valor |
|---|---|
| Content-type | multipart/form-data |
| IDEXA-API-KEY | [api_key] |
Payload
| Parâmetro | Descrição | Obrigatório | Tipo | Exemplos |
|---|---|---|---|---|
| files | Documento(s) a ser(em) processado(s) | Sim | File | "arquivo.pdf" |
| type | Tipo do documento enviado | Sim | Integer | 1 |
| pages | Páginas a serem analisadas (Quando extensão for pdf) | Não | String | "1,2,5-10" |
| externalId | Id externo para controle do documento (não pode repetir) | Não | String | "0001" |
Exemplo
('files',('arquivo.pdf',open('/path/to/file/arquivo.pdf','rb'),'application/pdf'))
{
"type": 1,
"pages": "1,2,5-10",
"externalId": "0001"
}
Retorno
Status code 200
Ao enviar um documento, o retorno 200 dado pela api, irá enviar um objeto data nulo pois a inferência do documento ainda será feita. Para obter o resultado da Inteligência Artificial, é necessário utilizar a requisição vista na próxima sessão.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 1 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error, 3-In Progress) | Integer | 0 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, IN_PROGRESS, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 1,
"status": 0,
"statusDesc": "RECEIVED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
Para buscar o resultado do documento processado, disponibilizamos o método GET, mostrado a seguir. Pasta passar no parâmetro id, o UUID recebido no momento do upload.
GET URL Ambiente/documents/[id]
Header
| Identificador | Valor |
|---|---|
| Content-type | application/json |
| IDEXA-API-KEY | [api_key] |
Retorno
Status code 200
Um http code 200 é retornado quando o documento é inserido corretamente.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 1 |
| data | Objeto retornado pela IA | Modelo referente ao tipo do documento | json_object |
| processTime | Tempo de processamento | Float | 10.02232 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error) | Integer | 3 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 1,
"data": {
// Verificar em Modelo o resultado esperado desse documento
},
"processTime": null,
"status": 1,
"statusDesc": "FINISHED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| nome | Nome | String | Fulano da Silva Jr |
| validade | Validade | String | 20/02/2024 |
| nacionalidade | nacionalidade | String | BR |
| dataLocalUfDeNascimento | Data, Local e UF de nascimento | Unknown | 14/06/1986, VILHENA, RO |
| rgUf | Rg UF | String | RJ |
| cpf | CPF | String | 000.000.00-00 |
| cetpp | CETPP | String | |
| registro | Registro | String | 0000000000 |
| categoria | Categoria | String | B |
| filiacaoPai | Filiação Pai | String | Fulano da Silva |
| primeiraHabilitacao | Primeira habilitação | String | 21/02/2022 |
| rgEmissor | Rg Emissor | String | DETRAN |
| rg | RG | String | 00000000 |
| filiacao | Filiação | String | Ciclana da Silva |
| observacoes | Observações | String | Observações 1, 2 |
| dataDeNascimento | Data de nascimento | String | 21/02/1990 |
| rgNumero | Rg numero | String | 18618049 |